home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Pascal / source / list manager package ƒ / SampleTextList.txt < prev    next >
Encoding:
Text File  |  1990-01-07  |  6.1 KB  |  156 lines  |  [TEXT/MPS ]
  1.                       Mac Programming Tutorial Sample Code
  2.                       
  3.                           Written by Jack A. Littleton
  4.                           
  5.          Documentation for TextList--An example List Manager Application
  6.          ---------------------------------------------------------------
  7.  
  8.     This document and all files in this package are copyright © 1990 by 
  9.     Jack A. Littleton, All Rights Reserved.
  10.     
  11.     Version 1.0 - January 1, 1990
  12.  
  13.  
  14. Introduction
  15. ------------
  16.     This is one of several sample code packages that I developed as research
  17.     for a Macintosh programming tutorial that was written for my senior
  18.     project while a student at California State University, Chico.  Since
  19.     the project has been completed, I have decided to release this package
  20.     on a trial-run basis to the public to be of assistance to those learning
  21.     to program the Macintosh.
  22.     
  23.     The original senior project contained information for programming only
  24.     in Pascal, but I started writing in C after getting MPW C in January, 
  25.     1989.  I also plan to include assembly source in a later version of this 
  26.     package.  All the source was written in MPW, version 2.0.2.
  27.     
  28. LEGAL STUFF
  29. -----------
  30.     1. COPYING--This package is being released to the general public for
  31.                 use as a learning tool, but is not being released in the
  32.                 public domain.  You may distribute copies of this package
  33.                 only as long as no modifications have been made to the
  34.                 documentation or any of the source code files.  You cannot
  35.                 charge any amount of money for distribution other than fees
  36.                 for duplication, including cost of the media (should not
  37.                 exceed four dollars).  Distribution rights are granted only
  38.                 to individuals or non-profit organizations, BUT ARE NOT
  39.                 GRANTED TO BUSINESSES OR CORPORATIONS.  You can
  40.                 use portions of the source code files in this package in
  41.                 your programs, or may modify the source code for use in
  42.                 your program.  You do not need to make any credits in 
  43.                 your program if you do use any portion of the source code
  44.                 in this package.
  45.         
  46.     2. WARRANTY--Because this package is being provided free of charge, 
  47.                 there is no warranty for its usefulness.  Although the 
  48.                 source code has been carefully checked, this package is 
  49.                 being provided "as-is" without warranty of any kind.  The
  50.                 entire risk of the results and performance of the package
  51.                 is assumed by you.  If any of the source code files or
  52.                 documentation files prove defective in any way, you assume
  53.                 the entire cost of all necessary servicing, repair or
  54.                 correction.
  55.     
  56.                 IN NO EVENT WILL JACK A. LITTLETON BE LIABLE TO YOU FOR 
  57.                 DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER
  58.                 SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF 
  59.                 THE USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO 
  60.                 LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES 
  61.                 SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PACKAGE TO 
  62.                 OPERATE WITH ANY OTHER PROGRAMS) THIS PACKAGE, EVEN IF YOU 
  63.                 HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR
  64.                 ANY CLAIM BY ANY OTHER PARTY.
  65.  
  66.     By using any file in this package, you agree to be bound by the terms
  67.     listed above.
  68.     
  69. DISCLAIMER
  70. ----------
  71.     This package is not a product of, or related to in any way to, California
  72.     State University, Chico.
  73.     
  74. PROGRAM INFORMATION
  75. -------------------
  76. Most of the documentation for the package occurs in the source code files.
  77. In order to use this package to it's fullest extent, you should have:
  78.     1)    Inside Macintosh (yes, all five volumes!  They're worth it!)
  79.     
  80.     2)    A development system.  This package was developed with Macintosh
  81.         Programmers Workshop (MPW) version 2.0.2, but should be useful with
  82.         any development system.  NOTE:  If you do not have MPW, you will 
  83.         not be able to open any of the files in the package by double-
  84.         clicking on them.  If this is the case, then launch your development
  85.         system, then choose "Open" from the File menu to open the files.
  86.     
  87.     3)    A knowledge of Pascal or C (or both).  If you don't, you should 
  88.         have some sort of tutorial for the language of your choice.  The 
  89.         documentation does not contain information about the syntax of the
  90.         language; it only covers Macintosh-related subjects.
  91.  
  92. FEATURES
  93. --------
  94. The application created by the source code contained in this package has the
  95. following features:
  96.     • Multiple windows with a single list in each window
  97.     • Windows that support growing and zooming
  98.     • Direct text entry into the cells in the list
  99.     • Cut/Copy/Paste between cells in the same list
  100.     • Horizontal and Vertical scrolling
  101.     • User settable options:
  102.         Cell size
  103.         Font & font size
  104.         Indentation of text in the cell
  105.     • The user can set various List flags that affect the way the list 
  106.       handles cell selections.
  107.     • "Find" is supported
  108.     • As many of the List Manager routines as possible are shown in the source
  109.       code.
  110.  
  111. BUGS
  112. ----
  113. I have made a thorough check for bugs in the source in this package and found
  114. the following:
  115. <<Both these bugs show up only in the C version>>
  116.  
  117. Window titles don't show what they're supposed to.
  118.  
  119. The program will crash after quitting when an Adobe screen font was selected
  120.     from the font menu.
  121.     
  122. A full discussion of bugs is given in the documentation section of the
  123.     source file.
  124.  
  125. If you do find bugs, let me know at one of the addresses listed below.
  126.  
  127. ADDRESSES
  128. ---------
  129. I mentioned that I'm releasing this package on a trial-run basis at the 
  130. start of this document.  I will release other packages if the response to
  131. this package is good enough.  Even though the source has already been 
  132. written, a great deal of work is put into documentation and cleaning up
  133. the code, and I don't want to do a lot of work for nothing.  Other packages
  134. that I've written include:
  135.  
  136.         • Low-level file manager calls
  137.         • Menus (hierarchical, pop-up, and icons/marks in menus)
  138.         • Dialogs (dialog filters, useritem procedures)
  139.  
  140. If you liked this package, and want to see more, leave a note saying so to
  141. one of the following addresses:
  142.  
  143. ••EMail addresses
  144.     Internet:    jackl@csuchico.edu@relay.cs.net   *or*
  145.                 jack@csufres.csufresno.edu
  146.     
  147.     GEnie:        J.LITTLETON
  148.     
  149.     Compu$erve:    76337,232
  150.  
  151. ••US Mail
  152.     P.O. Box 5301
  153.     Chico, CA 95927
  154.     
  155. P.S. I just graduated and will be looking for a job Real Soon Now…If you like
  156. what you see here and need a Mac programmer, let me know.